home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / util / blank / AntiBlanker.readme < prev    next >
Encoding:
Text File  |  2000-11-02  |  9.3 KB  |  230 lines
  1. Short:    A tool that disables your screen blanker when certain tasks are running
  2. Author:   Ghandi <ghandi@cremlinsoftware.org> and Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  3. Uploader: Alexander Niven-Jenkins <anj@cremlinsoftware.org>
  4. Type:     util/blank
  5. Replaces: AntiBlanker.lha
  6. Requires: OS3.x and at least a 68020
  7.  
  8. *******************************************************************************
  9. *** IF YOU STILL REQUIRE OS2.x SUPPORT, V1.1 IS AVAILABLE FROM OUR WWW SITE ***
  10. *******************************************************************************
  11.  
  12. Why was it written?
  13. ~~~~~~~~~~~~~~~~~~~
  14. Because the screen blanker we were using would eat up too much CPU time when we
  15. were trying to burn CDRs thus ruining them, and we kept forgetting to disable
  16. it beforehand, so we thought we would get our Amiga to do it for us.
  17.  
  18.  
  19. How do I run AntiBlanker from Workbench?
  20. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  21. Just double click on the AntiBlanker icon.  In order to tell AntiBlanker what
  22. tasks to look out for you must setup it's tool types as follows:
  23.  
  24. DELAY=<the delay between checks (in 1/50ths of a second)>
  25. BLANKCODE=<the blank key code, see below>
  26. BLANKQUALIFIER=<the blank qualifier, see below>
  27. TASK=<the task name you would like to disable your screen blanker for>
  28.  
  29. e.g.:
  30.  
  31. DELAY=6000
  32. BLANKCODE=0x0062
  33. BLANKQUALIFIER=0x0004
  34. TASK=MakeCD
  35. TASK=PalomaTV
  36.  
  37. The above would disable your screen blanker when ever MakeCD or PalomaTV are
  38. running, and it will check to see if they are running every 2 minutes
  39. (6000/50/60 = 2 minutes), but
  40.  
  41.  
  42. How do I run AntiBlanker from the CLI?
  43. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  44. Type the following at a CLI prompt:
  45.  
  46. <Path>AntiBlanker <Config #1> <Config #2> ... <Config #n>
  47.  
  48. Where <Config #n> are any number of configuration files, AntiBlanker will
  49. automatically append them all together.  The format of the configuration files
  50. are as follows:
  51.  
  52. Line1      the delay between check (in 1/50ths of a second)
  53.            same as DELAY tooltype
  54. Line2      the blank key code (see below)
  55.            same as BLANKCODE tooltype
  56. Line3      the blank qualifier (see below)
  57.            same as BLANKQUALIFIER tooltype
  58. Line4 .. x the task name you would like to disable your screen blanker for
  59.            same as TASK tooltype
  60.  
  61. nb. when using multiple configuration files, AntiBlanker uses the DELAY,
  62.     BLANKCODE and BLANKQUALIFIER from the last configuration file specified.
  63.  
  64.  
  65. What are the blank code and blank qualifier?
  66. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  67. AntiBlanker works by putting 'fake' input events onto the input chain, thus
  68. fooling your screen blanker into thinking you've pressed a key when you
  69. haven't.  Versions before 0.4 used the 'Control' <Ctrl> key for this purpose as
  70. we thought it was least likely to cause any conflicts, unfortunately we did not
  71. fill in the input event with a single <Ctrl>, but instead we accidentally set
  72. it to <Ctrl> + <'> and this would produce 'trash' in a shell window and in some
  73. software.
  74.  
  75. As of version 0.5 you can specify the blank code and blank qualifier (see
  76. above), this allows you to program AntiBlanker to 'fool' the system with any
  77. key you like.  You can specify the codes as hex or decimal by copying them
  78. exactly from the tables below (the tables are not complete, but should get you
  79. started).
  80.  
  81. Blank codes
  82. ~~~~~~~~~~~
  83. Key               Hex Code      Decimal Code
  84. ---               --------      ------------
  85. Left Shift        0x0060        96
  86. Right Shift       0x0061        97
  87. Caps Lock         0x0062        98
  88. Control           0x0063        99
  89. Left Alt          0x0064        100
  90. Right Alt         0x0065        101
  91. Left Amiga        0x0066        102
  92. Right Amiga       0x0067        103
  93.  
  94. nb. the above blank codes work on our A1200, although they may be slightly
  95.     different for other Amigas (and possibly foreign keyboards), if you get
  96.     'trash' in a shell window while using AntiBlanker try a different code.
  97.  
  98. Blank qualifiers
  99. ~~~~~~~~~~~~~~~~
  100. Key               Hex Code      Decimal Code
  101. ---               --------      ------------
  102. Left Shift        0x0001        1
  103. Right Shift       0x0002        2
  104. Caps Lock         0x0004        4
  105. Control           0x0008        8
  106. Left Alt          0x0010        16
  107. Right Alt         0x0020        32
  108. Left Amiga        0x0040        64
  109. Right Amiga       0x0080        128
  110.  
  111. If you find one of the above keys conflicts with your software try another.
  112.  
  113. nb. the Caps Lock codes do not appear to actually affect the status of
  114.     Caps Lock itself.
  115.  
  116.  
  117. Which blankers work with AntiBlanker?
  118. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  119. AntiBlanker has been tested and proven to work with the following screen
  120. blankers, although it should work with almost any screen blanker.  If you have
  121. tested it with a blanker not listed, please let us know the results so that we
  122. can update the list.
  123.  
  124. Blanker                           AntiBlanker version  Comments
  125. -------                           -------------------  --------
  126. extras:tools/commodities/Blanker  0.1+
  127. util/cdity/mcx280.lha             0.1+
  128. util/blank/ASwarmII2_0.lha        0.2+
  129. util/blank/Auror15a.lha           0.2+
  130. util/blank/BeyondTheDark.lha      0.2+
  131. util/blank/Blanker2.6.lha         0.2+
  132. util/blank/DesktopMAGIC.lha       0.2+
  133. util/blank/GBlanker36.lha         0.2, 0.3, 0.5+
  134. util/blank/GBlanker36_020.lha     0.2, 0.3, 0.5+
  135. util/blank/FlyingToasters.lha     0.2+
  136. util/blank/MTX.lha                0.2+                 MTX 1.5+ required
  137. util/blank/ShadowMaster.lha       0.2+
  138. util/blank/StarBlanker.lha        0.2+
  139. util/blank/SwazBlanker240.lha     0.2+
  140.  
  141.  
  142. Miscellaneous notes
  143. ~~~~~~~~~~~~~~~~~~~
  144. Task names are CASE SENSITIVE, you can find out the name of task via a tool
  145. such as Scout.
  146.  
  147. To stop AntiBlanker, send it a CTRL-C signal either via the Break/BreakName
  148. programs or by a tool such as Scout.  Please note that AntiBlanker will not end
  149. immediately but after it's next loop.
  150.  
  151. To get the best performance out of AntiBlanker (so that it uses the least CPU
  152. time), put the tasks that you use most at the bottom of the tool type list (or
  153. configuration files).  Due to the way AntiBlanker stores the task names
  154. internally it actually checks for the tasks in the reverse order to the how you
  155. specify them.
  156.  
  157.  
  158. Registration and contacting us
  159. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  160. AntiBlanker is 'email ware', this means that if you use it then you must send
  161. us an email.  As you can see this is a very small cost to pay.
  162.  
  163. Also feel free to visit our website at http://www.cremlinsoftware.org/ it hosts
  164. all the latest versions of our software (including BETA releases).
  165.  
  166.  
  167. History
  168. ~~~~~~~
  169.  
  170. Version   Date        Comments
  171.  
  172. 0.1       15.06.1998  · First public release.
  173.  
  174. 0.2       15.06.1998  · Fixed AntiBlanker so that it works with Garshneblanker.
  175.                         [Luca 'Hexaae' Longone]
  176.  
  177. 0.3       05.09.1998  · Fixed an Enforcer hit that was caused by our linked
  178.                         list class.
  179.                         [Luca 'Hexaae' Longone]
  180.  
  181. 0.4       14.09.1998  · Added user definable blank key.
  182.                       · Altered the code so it sends a KEY_UP event instead of
  183.                         a KEY_DOWN.  This should reduce the amount of conflicts
  184.                         with existing software.
  185.  
  186. 0.5 BETA  15.09.1998  · Added the BlankCodeFinder program to the AntiBlanker
  187.                         package.
  188.                       · Changed user definable blank key so that it is
  189.                         specified as a CODE and QUALIFIER, instead of just a
  190.                         QUALIFIER.
  191.                       · Altered the code so it sends a KEY_DOWN event like 0.3
  192.                         did, as we had forgotten this was necessary for
  193.                         Garshneblanker compatibility (oops).
  194.  
  195. 1.0       15.02.2000  · Finally fixed the Enforcer hit on startup (that only
  196.                         took 1½ years).
  197.                         [Luca 'Hexaae' Longone]
  198.                       · Configuration file(s) are now closed properly.
  199.                       · Added CTRL-C support.
  200.                       · A number of internal optimisations and recompiled with
  201.                         the new OS3.5 includes.
  202.  
  203. 1.1       05.03.2000  · Our linked list class has been enhanced and cleaned up
  204.                         for one of our other projects, so we have recompiled
  205.                         AntiBlanker to accomodate the new class.
  206.                         No real changes have been made to the program itself.
  207.  
  208. 1.2       04.06.2000  · General cleanup of the code which has reduced the
  209.                         executable size slightly and AntiBlanker should use
  210.                         ever so slightly less memory.
  211.                       · AntiBlanker does now work with MTX, thanks to it's
  212.                         author for rewritting the checking code :-)
  213.                       · We have moved from HiSOFT C++ to StormC, basically
  214.                         because StormC is still being developed.
  215.  
  216. 1.3       10.09.2000  · A few minor optimisations generated by work on our
  217.                         other projects.
  218.  
  219.  
  220. ============================= Archive contents =============================
  221.  
  222. Original  Packed Ratio    Date     Time    Name
  223. -------- ------- ----- --------- --------  -------------
  224.     8800    5446 38.1% 10-Sep-00 11:27:56  AntiBlanker
  225.       35      35  0.0% 10-Sep-00 11:27:56  AntiBlanker.cfg
  226.      580     281 51.5% 10-Sep-00 11:27:56  AntiBlanker.info
  227.     9028    3377 62.5% 10-Sep-00 11:27:56  AntiBlanker.readme
  228. -------- ------- ----- --------- --------
  229.    18443    9139 50.4% 10-Sep-100 20:12:50   4 files
  230.